home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
tvd121.zip
/
TCBVD121.DOC
< prev
next >
Wrap
Text File
|
1992-01-24
|
61KB
|
1,373 lines
The Verify Door v1.21
January 24, 1992
Callback Verification Door
Copyright (c) 1992 by Jim Lockhart
Chapter Table of Contents
1.0 ......... Program Description
2.0 ......... System Requirements
2.1 ..... Modem Compatibility
2.2 ..... Setting Up Your HST Modem
2.3 ..... USR HST 14.4 Suggested Settings
3.0 ......... Error Handling
4.0 ......... Demo License
5.0 ......... Registration License
6.0 ......... Disclaimer
7.0 ......... Beta Testing
8.0 ......... System File Names
9.0 ......... System Files and Formats
9.1 ..... TCBV.CNF Short Line by Line Description
9.2 ..... TCBV.CNF Line by Line Description and Usage
9.3 ..... TCBVNAL
9.4 ..... TCBVVER
9.5 ..... TCBVTIME
9.5.1 TCBVTIME Parameters
9.6 ..... TCBVAL
9.6.1 Dialing String Format
9.7 ..... TCBVAREA
9.8 ..... The LOG file
10.0 ......... The Verify Door Operation
10.1 ..... Status Bar Description
10.2 ..... Single Node Operation
10.3 ..... Multi-Node Operation
10.4 ..... Exit Codes (DOS Errorlevel)
11.0 ..... Registering The Verify Door
12.0 ..... Technical Support
13.0 ..... Registration Form
1.0 PROGRAM DESCRIPTION
───────────────────
The Verify Door (TVD) is a door program designed specifically to
run with PCBoard v14.x and 14.5a. This program automatically
handles verification of your new users phone number by establishing
callback verification.
The user enters the door and enters his phone number. The user's
phone number is checked against a trashcan file then against
previously verified phone numbers and finally is checked for what
time of day it may be dialed.
The door then drops carrier on the user and after a sysop
configurable amount of time dials the number that the user entered.
If no modem is found at the user end the results are stored and
TVD recycles to PCBoard. If carrier is detected the user is
prompted to enter his password. If the password entered matches
the password from that users record in the user file the users'
security level is upgraded along with other optional user settings
as defined by the Sysop. The user gets two tries at entering
his password. After the second wrong password entry (or no password
was entered) the user is disconnected and TVD recycles to PCBoard.
TVD will attempt to dial the maximum number of times you have it
configured for, however, only two CONNECTions are allowed each time
the door is run. This helps limits hackers from tying up your phone
lines and should also help your long distance phone bill.
This version contains a small amount of self-test code to help
ensure executable file integrity.
2.0 SYSTEM REQUIREMENTS
───────────────────
TVD is multitasking compatible (at least with DesqView v2.3),
and is also known to function correctly on Novell and 3Comm. TVD is
compatible with COM1-8, IRQ 1-7 and bauds up to 115,200. TVD will
read your PCBOARD.DAT file and automatically retrieve the correct
communications port attributes.
TVD is specifically written to run as a PCBoard v14.x door and
should not be expected to operate with other bulletin board
software. It is compatible with single or multi-node PCBoard
operations, including the new PCBoard v14.5a code (see *note below.)
>>> TVD must have access to the following PCBoard system files on
each node running TVD:
PCBOARD.SYS PCBOARD.DAT USERS
TVD can be configured to access either your caller log(s) or
a separate log file(s).
* NOTE: This door will NOT operate on your system if you are using the
ENCRYPT program on your USERS file! If you are concerned
about the security of your users file to the point where you
have run the encryption program, then this door is not for you.
2.1 MODEM COMPATIBILITY
───────────────────
TVD has been found to function correctly on the following brands
of modems: Hayes, USR, Everex, Cardinal, Telebit, Ven-Tel and Hisland
modems. It should work OK on most 'Hayes compatible' modems.
The Verify Door will wait for a line of data to come in from
your modem that contains a recognizable result code string similar
to that of the HAYES standard. The following valid result codes are
parsed by TVD. If any of the following strings are returned
as result codes from your modem they are handled as described.
"NO ANSWER"─────> call retried
"BUSY" ─────────> call retried
"NO DIAL TONE" ─> call retried
"NO DIALTONE" ──> call retried
"NO CARRIER"────> call retried
"CONNECT" ──────> call connected at any baud rate
"RING " ────────> call retried ─ nasty mode turns on if enabled
"VOICE" ────────> call retried
If no response is received from your modem within the timeout
period specified in the TVD config file, TVD will make an entry to
the specified log file and will return to PCBoard.
NOTE TO USR HST USERS: If you have recently upgraded your HST
to v.42 bis, be sure you check and reset S38=0 if necessary. There
is a known bug in some releases of the new 'supervisor' chip that
sets your S38 register to 255 when the chip is first installed! TVD
will not function properly if this register is set to more than 2 or
3 seconds, so set it to 0 just to be on the safe side.
NOTE TO TELEBIT MODEM USERS: Check and reset S38=0 if needed.
TVD won't like it one little bit (no pun intended) if this setting
is more than 2 or 3 seconds, so I suggest setting it to 0.
2.2 SETTING UP YOUR HST MODEM:
This door has been written to be compatible with all parameters
set by PCBMODEM.
One configuration parameter that you should make sure of -
dialtone checking should be ON! There are a few modems that when
connected to certain telephone company lines do not properly detect
the presence of a dial tone. If you have had a few of your friends
or users call and the code just doesn't seem to want to call them
back, then set your modems X parameter to X3 instead of X4. The X3
setting will disable your modem from sending the NO DIALTONE result
code back to the door code and the door should dial out whether you
modem thinks there's a dial tone or not. This should not present any
security problem because when the door dials out, it is looking for
the other modem to send carrier. I suggest using the X7 setting if
you are using an HST modem.
If you have problems with modem compatibility please report them
to Jim Lockhart at Page Three BBS, (407) 327─8421 (Node 1) or call
node 2 at (407) 327-4524. (PC-Pursuit users use FLORL)
Include a ZIPped copy of your configuration (TCBV*.*, and
error.log files), a description of the problem and what modem you
are running including any error codes given by the code when the
error(s) occurred.
2.3 USRobotics Courier 14400 HST Suggested Settings...
──────────────────────────────────────────────────
B1 C1 E0 F1 M0 Q0 V1 X7
BAUD=38400 PARITY=N WORDLEN=8
DIAL=HUNT ON HOOK TIMER
&A3 &B1 &C1 &D2 &G0 &H1 &I0 &J0 &K3
&L0 &M4 &N0 &P0 &R2 &S0 &X0 &Y1
S00=000 S01=000 S02=255 S03=013
S04=010 S05=008 S06=002 S07=060
S08=002 S09=006 S10=010 S11=050
S12=050 S13=000 S14=001 S15=008
S16=000 S17=000 S18=000 S19=003
S20=000 S21=010 S22=017 S23=019
S24=150 S25=000 S26=000 S27=000
S28=008 S33=000 S38=000
3.0 ERROR HANDLING & CARRIER LOSS
─────────────────────────────
Great pains have been taken to make The Verify Door as
user-foolproof and hacker proof as possible. In the event of some
kind of error, an entry is made in the ERROR.LOG file, then the
door will disconnect anyone who is still connected and recycle to
PCBoard. Hopefully no errors will occur, but I don't always write
perfect programs either! If carrier is lost for any reason other
than the door dropping carrier during a callback, the door will
detect loss of carrier and recycle to PCBoard. TVD will also
recycle to PCBoard if your modem doesn't respond to TVD commands
or gets no answer from a dialed phone number within the amount of
time specified in the modem response/no answer timeout setting.
Caution! TVD is not SYSOP proof. You must take the time and
care to configure TVD correctly or you will get unexpected errors!
I suggest using the installation/setup program that comes with this
version or you can print out the docs and carefully do it yourself.
If you get an error or you cannot get the door to operate on your
system and you cannot figure out what the problem is, feel free to
call Page Three BBS (numbers below) and leave a message or comment
to SYSOP or Jim Lockhart along with the error code issued.
Updates to TVD are always posted in the upload directory on
Page Three BBS. You can always call and immediately get the latest
release of The Verify Door unhacked and virus-free any time without
having to go through Page Three's verify door.
Just log in and download it....
ANOTHER NOTE: Please remember that, in the event you really mess up
the configuration of this door, your USERS file will
come to no harm! This door is written so that it MUST
be running EXACTLY right in terms of file access
before it will access the USERS file.
4.0 STANDARD "DEMO" LICENSE
───────────────────────
The Verify Door is a 'Shareware' program. I encourage everyone
to upload and share the code. Several limitations must be implied
however:
1) Under no circumstance shall the code be modified or distributed
in any other form than in that which it was originally supplied (the
original is ZIPped, but it may be distributed in other archive
formats as long as the de-compressed form of the program remains the
same).
2) The Verify Door may NOT be redistributed in any manner OTHER THAN
by electronic file transfer except in cases approved by the author.
Receiving money for The Verify Door program itself is absolutely
forbidden to anyone but the author, except for telecommunications
or service charges. No fee of more than $5.00 shall be collected
in such an instance.
3) The Verify Door may be run for an adequate amount of time to
allow a full testing of the software. If, after running the code
for 30 days, you do not purchase the registration license (cost is
$20.00 US) then this license is terminated and you must remove all
working copies of The Verify Door from your system.
4) UNMODIFIED copies of The Verify Door and its files may be
distributed to ANY bulletin board system anywhere.
5) The demo version may not be "hacked" or modified in ANY manner,
including but not limited to modifications leading to the enabling
of the extended features outlined in this document which are labeled
as being available only to those systems running The Verify Door
with an authorized Verify Door Registration Number. Under no
circumstance may anyone use a registration number in use by another
individual. The Standard "Demo" License as outlined above may be
withdrawn by the author of The Verify Door at any time without
exception.
5.0 REGISTRATION LICENSE
────────────────────
Users that decide to purchase a Verify Door Registration Number
receive several benefits as outlined below.
1) Once purchased, the registration license is non-refundable.
All future releases of The Verify Door written by Jim Lockhart,
its present author, will be compatible with any registration
license and The Verify Door Registration Number sold to the
individual purchasing the license.
2) The registration license authorizes use of all features marked in
this documentation as "Registered Version Only."
3) The registration license entitles the holder to free access to
Page Three BBS, the location of support maintained by the author, as
long as the holder of the license adheres to the policies of said
BBS. Note that Jim Lockhart may not be held liable in any manner or
for any reason for not supplying said access.
4) The registration license is non-transferable. The name of the
bulletin board registered may be changed if evidence is given that
such a change will take place. It is expressly forbidden to use the
old registration number once a new one is issued.
6.0 DISCLAIMER
──────────
The author of this software, Jim Lockhart, is not liable for any
lost funds, equipment, or data due to the use of this program except
under circumstances where it can be proven that code was
intentionally written by Jim Lockhart to do so.
7.0 BETA TESTING
────────────
Each version of The Verify Door is beta tested on the authors
system and several close by, along with other bulletin boards
choosing to beta test new code throughout North America. I try to
make sure that when you get a copy of the released version that
there is nothing in the door that could possibly go wrong. Please
realize that, though every effort is made, some errors may slip
through. If an error occurs and you can't find the problem on your
own then please notify me as soon as possible, despite all the legal
stuff. I'll do the best I can to take care of any problem with
successfully running The Verify Door that you might have.
8.0 SYSTEM FILE NAMES
─────────────────
ERROR.LOG > This file will be created in the directory in which
TCBVDxxx resides in the event of an error. This is the
file you want to look at when reporting errors that you
cannot resolve on your own.
The following files must exist in your Verify Door working directory:
TCBVDxxx.EXE > main executable door code
WELCOME > initial user instructions (text)
WELCOMEG > initial user instructions (ansi)
TCBVTEXT > file containing all text messages that appear
TCBVAL > allowed numbers file listing (described in full detail
later in this file)
TCBVAREA > area code file of area codes local to you
TCBVVER > verified numbers/names/dates file (described later)
TCBVTIME > time format file (described later)
TCBVNAL > specifically disallowed numbers (described later)
SETUPxx.EXE > setup program
9.0 SYSTEM FILES AND FORMATS
────────────────────────
TCBV.CNF (configuration file overview)
The TCBV.CNF file is the main configuration file central to
operation of The Verify Door. It includes drive/path/filename
information on your PCBoard and TVD system files, TVD registration
information and various other feature enable/disable settings.
For a complete description of each entry see the following
sections 9.1 and 9.2. All entries in your TCBV.CNF file must be
left justified.
Please run the SETUPxx.EXE program first if this is the initial
installation of TVD on your system to ensure that the correct
path names get entered into the config file.
9.1 The TCBV.CNF file:
Line Description Example
──── ─────────── ───────
1 Maximum redial attempts if Local 5
2 Maximum redial attempts if Long Distance 2
3 Enable long distance dialing?
(Enable = y Disable = n) y
4 Location and name of PCBOARD.SYS file C:\PCB\PCBOARD.SYS
5 Location and name of PCBOARD.DAT file C:\PCB\PCBOARD.DAT
6 Name of your BBS (Also see line 8) Page Three BBS
7 Registration number
(0 = demo copy) 0
8 Use system name from PCBOARD.DAT ?
(Y=use system name from PCBOARD.DAT,
N=use system name from config file entry) Y
9 Location and name of log file. May be
the PCBoard CALLER log or a separate
text type log. C:\DOOR\LOG.TXT
10 Security level of 'new user' 1
11 Security level to increase user to
after verifying 62
12 Amount of time to add to user on line time 5
13 Enable local screen status bar?
(Y = enable, N = disable) y
14 Check trashcan and previously verified
numbers before dialing?
(Y or N) (Registered version only) y
15 Running multi-node or in a network? (Y or N) y
16 Your time zone. Any time zone designation
up to 8 characters long may be used.
Examples: Eastern, Central, Mountain,
Pacific, EDT, EST, CDT, CST, etc. Eastern
17 Enable Auto-ANSI color graphics ?
(enable = Y, disable = N) y
18 ALWAYS disconnect user at the completion of
verification ?
(enable=y, disable=n) n
19 New expired security for user
(disable = N)
(enable = 1, 2 or 3-digit entry) n
20 Sysop maintained comment field
(enable = Y, disable = N) y
21 Configurable upload/download stats line #1 n
(Active in Registered versions only)
22 Configurable upload/download stats line #2 n
(Active in Registered version only)
23 Configurable upload/download stats line #3 n
(Active in Registered version only)
24 Configurable upload/download stats line #4 n
(Active in Registered versions only)
25 Delay time before dialing out
(seconds in addition to built in
9 second built-in delay) 0
26 'Nasty' dial out enabled ?
(n=ask for name only) y
27 Modem response/no answer timeout in seconds 60
9.2 TCBV.CNF (configuration file - line by line description)
────────────────────────────────────────────────────────
1 Maximum redial attempts if caller is Local
──────────────────────────────────────────
Options: Recommended setting is 5.
Valid entries: 2 through 9
This entry sets the maximum number of times TVD will attempt
to dial out when the last attempt got something other than
CONNECT* from the modem and the user is calling from a local
telephone number.
*There is non-configurable maximum of two CONNECTions allowed
each time TVD is run.
2 Maximum redial attempts if caller is Long Distance
──────────────────────────────────────────────────
Options: Recommended setting is 2.
Valid entries: 2 through 9
This entry sets the maximum number of times TVD will attempt
to dial out when the last attempt got something other than
CONNECT* from the modem and the user is calling from a long
distance telephone number.
*There is a non-configurable maximum of two CONNECTions allowed
each time TVD is run.
3 Enable long distance dialing?
─────────────────────────────
Options: y - allow L.D. dialing in accordance with TCBVAL and
TCBVTIME
n - NEVER dial long distance (override other settings)
This entry tells The Verify Door whether or not to EVER call long
distance to verify a user. If you set this option to N, TVD will
NEVER call long distance and will over-ride all other long
distance calling options you may have set in the TCBVAL file.
Setting this option to Y tells TVD to dial long distance in
accordance with parameters set in the TCBVAL and TCBVTIME files.
4 PCBOARD.SYS file name & location
────────────────────────────────
Entry: Complete drive\path\filename of pcboard.sys
This entry tells The Verify Door the location and name of your
"PCBOARD.SYS" file.
5 PCBOARD.DAT file name & location
────────────────────────────────
Entry: Complete drive\path\filename of pcboard.dat
This entry tells The Verify Door the location and name of your
"PCBOARD.DAT" file.
6 System Name
───────────
Place the name of you bbs on this line.
If the entry on line 8 is N, then TVD will use the system name as
you have entered it on line 6.
If line 8 is set to Y, TVD will use the system name it reads
from PCBOARD.DAT and will ignore the entry on this line.
7 Registration number
───────────────────
Place a 0 on this line if you are running the demo copy
of The Verify Door.
If you have registered your code place the registration number you
were supplied with on this line to enable the additional features
found in the registered software.
8 Use the system name as read from PCBOARD.DAT?
─────────────────────────────────────────────
Options: Y or N
When this option is set to Y, TVD will read your BBS name from
PCBOARD.DAT and will ignore any entry made on line 6 of the config
file. When set to N, TVD will read the system name you gave on
line 6 and will ignore the system name contained in PCBOARD.DAT.
9 Log file
────────
This line contains the location and name of your TVD log. The
Verify Door will append to the PCBoard caller file if specified.
However, it is recommended that you create a separate log file in
the directory in which your door code resides.
10 Security level of new user
──────────────────────────
This is the security level of a new user. If a user enters the door
and his/her security level does not match this number the user will
be returned to the PCBoard system.
11 Security level to raise user to after verification
──────────────────────────────────────────────────
This is the security level you wish to give the user after he/she
has been successfully verified.
12 Number of minutes to add to time limit after verifying
──────────────────────────────────────────────────────
This is the number of minutes you wish to add to a users time limit
after he/she has been verified. Since PCBoard 14.5 will
automatically adjust the users time after The Verify Door upgrades
his/her security level, it is not necessary to put more than 5
minutes or so in this option. This feature was included so that the
sysop can compensate the user for average time spent in The Verify
Door.
13 Enable local screen status bar ?
────────────────────────────────
Options: Y or N
The Verify Door will display a status bar at the bottom of the local
screen if this flag is set to Y. This status bar is meant to look
similar to but not identical with the one PCBoard displays. Set this
flag to N if you do not wish to have the status bar appear.
14 Check trashcan and previously verified numbers before dialing?
───────────────────────────────────────────────────────────────
Options: Y or N
This option is active only on the registered version and
is ignored on the demo copy.
If a user is about to be verified and this flag is set to 'y'
(and the copy you are running is registered) his/her phone number
will be checked against all entries in the TCBVVER and TCBVNAL
files and will not be dialed if an entry with the same phone
number in either file was found.
What will the demo version do?
The demo version of TVD will check only the first three entries
in the trashcan file TCBVNAL regardless of this setting.
The verified users file TCBVVER WILL be written to upon successful
user verification but will NOT be checked for entries with the same
phone number when another new user who is about to be verified uses
the door. Registering TVD will fully enable the checking features
outlined above
15 Running multi-node or in a network environment?
───────────────────────────────────────────────
Options: Y or N
With this flag set to yes, you should have SHARE loaded.
>>>Set this flag to N if you are running one node of PCBoard.<<<
>>>This flag need NOT be set to Y if you are multitasking and
running only 1 node of PCBoard<<<<
Setting this flag to Y indicates to the door that you are running
more than one node of PCBoard and that files such as the USERS file,
TCBVVER, etc., must be shared by both copies of PCBoard and both
copies of The Verify Door.
16 Your Time Zone.
───────────────
You should enter your time zone here. Any entry up to 8 characters
is accepted. This setting is used when a user calls long distance
and tries to get verified outside of the time range(s) you have set
for your system to call long distance. The user will get a three
line prompt telling him what the next 'time slot' for calling him
long distance is. The user is displayed the times along with
whatever you put on this line of the config file. Some examples:
Eastern, Central, Pacific, Mountain, EST, EDT, CDT, CST, MDT, MST,
PDT, PST, etc.
17 Enable Auto-ANSI Color graphics ?
─────────────────────────────────
Options: Y or N
With this flag set to "Y" The Verify Door will automatically turn on
ANSI color if the user has the color mode turned on in PCBoard. Set
this flag to "N" if you never want color used in the door no matter
what the users settings are in PCBoard.
Note: Color graphics will not appear on the local screen if the
network/multitasking flag is set to Y.
18 Always disconnect user at end of verification?
──────────────────────────────────────────────
Options: Y, N
If you would like to disconnect the user after a successful verify,
then set this flag to Y. The door will then disconnect the user
regardless of whether he is calling long distance or local. Set this
flag to N if you wish only to disconnect long distance users after
verification. Users will be automatically disconnected under the
following conditions:
Keyboard timeout.
Pressing enter too many times.
Pressing enter when the door asks for password.
User enters wrong password twice.
19 New expired security to give user
─────────────────────────────────
Options: 1, 2 or 3 digit number, or the letter N.
Enter the expired security level you wish the verified user to have
and it will be written to the users record in the user file when
the user is successfully verified.
You can also put N as an entry here if you do not want any change
in the users expired security level.
20 Sysop maintained comment field enabled?
───────────────────────────────────────
Options: Y or N
This option when set to Y allows The Verify Door to write the
verified user phone number to the sysop-maintained comment line in
that users record in the user file. (Comment line #2)
21 Configurable upload/download statistics line #1
───────────────────────────────────────────────
Once your new user is verified, you may wish to modify his/her
upload/download statistics especially if you are running PCBoard
with some sort of ratio tracking.
Use lines 21, 22, 23 and 24 in the config file if you wish to adjust
the users record for the following statistics:
1st 2 letters
Statistic type: of the entry: Valid range
────────────────────────── ───────────── ──────────────
Number of files uploaded fu 0 to 32767
Number of files downloaded fd 0 to 32767
Number of bytes uploaded bu 0 to 999999999
Number of bytes downloaded bd 0 to 999999999
Make only one entry per line. These four lines may be configured
in any order you like (ie, fuxxx does not have to be on line 21).
Entries should be in the format:
ccn
where the first two characters will be one of the following:
fu, fd, bu or bd
and where n is any number within the valid range listed above.
NOTE: If you do not wish to change ANY of the users upload/download
statistics, enter an 'n' on each of the four lines. If you wish to
change only one, two, or three statistics, make your entries as
necessary, then make an 'n' entry on each of the four lines not
used.
For example, lets say you want to give the user credit for one file
uploaded. The entry would read: fu1
Or, lets say you want to give the user an upload byte credit of
123456 bytes, the entry would read: bu123456
More examples:
entry: what it does:
bu1024 enter 1024 bytes upload credit to the user record
fu100 enter 100 files upload credit
fd10 enter 10 files download debit
bd100000 enter 100000 bytes download debit
Lets say you wanted only to enter an upload file credit of, say, 1
file to the users record, but don't want to change anything else.
Lines 21-24 might look something like this:
fu1 n n n
n fu1 n n
n OR n OR fu1 OR EVEN n
n n n fu1
Any one of those four ways of writing lines 21-24 will get the job
done. (Yes, this program is so user friendly, you can mix and match
these four lines as you see fit!)
(Registered version only. Lines 21, 22, 23 and 24 are ignored in the
demo version)
22 Valid entries described above, see line 21
23 Valid entries described above, see line 21
24 Valid entries described above, see line 21
25 Delay time before dialing out in seconds
────────────────────────────────────────
This setting allows the TVD to compensate for modems that are slow
to disconnect from the phone line and also for slow to respond phone
lines. The Verify Door has a built in 9 second delay, so whatever
you put on this line of the config file is in addition to the 9
second built in delay. Keep in mind that even though your modem may
show that the phone is back on hook that it takes up to several
seconds for your users modem to give up the phone line and issue
your user a NO CARRIER message.
26 'Nasty' dial out?
─────────────────
Options: Y or N
This setting allows you to determine how TVD dials out under
conditions that are normally found only on very busy bulletin
boards. When set to N, The Verify Door will dial out normally and in
pretty much the same manner as any other communications program.
When set to Y, however, The Verify Door will dial out in the 'Nasty'
mode where if it detects an incoming call while it's trying to dial
out, it will pick up your modems phone line, wait 3 seconds while
doing nothing, hang up, wait 1 second and then attempt to dial out
to the new user. Use this feature only if you notice a lot of 'RING'
or 'NO DIALTONE' messages in your doors log file and only if you are
certain The Verify Door is working correctly.
This feature is also know as a "forced off-hook" option.
27 Modem no-response/no answer timeout
───────────────────────────────────
Valid entries are 30 to 300 (seconds)
Suggested setting: 60 seconds
This setting allows you to determine how TVD will react if your
modem does not return a recognizable response code to TVD commands
within the amount of time you set. It also doubles as a NO ANSWER
timeout in case your modem can't be or isn't configured for it.
TVD makes a log entry of NO MODEM RESPONSE or NO ANSWER and returns
to PCBoard upon timing out in either case.
9.3 TCBVNAL FILE
────────────
The phone number trashcan file (TCBVNAL) is used primarily as a
place to store any SPECIFIC telephone numbers that you do not want
The Verify Door to dial (such as the numbers of other local BBS's,
the police/fire/ambulance numbers, information, etc.) This file is
also used to store telephone numbers that you do not want dialed. To
do this simply place the complete phone number in the file, in the
following format:
aaa-ppp-ssss Example: 407-675-3244
│ │ │ 900-???-????
│ │ suffix Note: Wildcard (as shown) may be
│ prefix used disallow calling of groups
area code of numbers.
The demo version reads and acts upon only the first three entries in
this file. The registered version reads and acts upon ALL entries
in this file.
>>>> BE ADVISED! BE SURE you have the following two entries in your
TCBVNAL file:
911-???-????
???-911-????
The above entries will prevent the 911 squad from showing up at
your front door step in the middle of the night should some wise-guy
user decide to enter this as a number to verify!
If you are running the DEMO version, I suggest making sure that the
above two entries are the first two entries in TCBVNAL because the
DEMO version reads only the first THREE lines in this file!
9.4 TCBVVER FILE
────────────
Every phone number successfully verified by The Verify Door is
placed in this file. The Verify Door adds to this file to store the
name of the user and the time/date the number was verified.
For example:
"407-555-1212","JIM LOCKHART","06-25-1990"
│ │ │
phone number last, first date of verify
NOTE: The demo version of The Verify Door will append entries to
the TCBVVER file but will not check for previously verified
phone numbers.
Once TVD is registered, it will read all existing entries in
the TCBVVER file and will eliminate the problem of one user
calling your system using several different log-in names because
the registered version of TVD will not call an already verified
number back. (This was the main purpose for writing TVD in the
first place.)
9.5 TCBVTIME FILE
─────────────
The TCBVTIME file is used in conjunction with the TCBVAL file to
determine what time of day a number or group of numbers may be
dialed. This feature will help cut down phone costs. The TCBVTIME
file is a text file that consists of three entries, each separated
by a comma. Shown below is a diagram of an entry in TCBVTIME:
A, 23:05, 07:55 (see 9.5.1 below for complete
┬ ──┬── ──┬── descriptions of each entry)
│ │ │
│ │ │
│ │ stop time
│ start time
Time period letter that appears in TCBVAL
9.5.1 TCBVTIME PARAMETERS
───────────────────
'start time' = This is the time to start allowing entries with this
format letter to be dialed. Valid entries are 00:00 through 23:59
'stop time' = This is the time to stop allowing entries with this
format letter to be dialed. Valid entries are 00:00 through 23:59
The Sysop may define up to 26 different time periods, one for
each letter of the alphabet. After setting a time period up in the
TCBVTIME file, include the letter you configured it for in each
entry of TCBVAL you wish to use the TCBVTIME entry defined. If a
user calls outside of a valid start/stop time, TVD will display the
next available valid time period for calling him back.
>>> Please note: 24:00 is NOT a valid time entry.
9.6 TCBVAL FILE
───────────
The TCBVAL file is used to tell The Verify Door what phone
numbers it may call and how to go about doing so. The Sysop defines
what number(s) it can dial (exchange, prefix, suffix, and what the
user has answered to the long distance question), when they can be
dialed (used in conjunction with the TCBVTIME file), and what to
send to the modem when dialing the number that matches that TCBVAL
entry. The TCBVAL file consists of one line for each phone number
criteria you wish to give it. Each line entry in this file consists
of four fields. Shown below is the general TCBVAL entry format:
407-???-????,N,A,"ATDT%02%003"
┌── ┌── ┌─── ┌ ┌ ┌───────────
│ │ │ │ │ │
│ │ │ │ │ dialing string format to send (Note 4 and 9.6.1)
│ │ │ │ │
│ │ │ │ time period to allow calling (Note 3 and 9.5)
│ │ │ │
│ │ │ long distance flag (compared to users answer) (Note 2)
│ │ │
│ │ suffix (? marks used as a wildcard character) (Note 1)
│ │
│ prefix (Note 1)
│
area code (Note 1)
Notes:
1) The phone number field. This field may consist of digits or the
wildcard character "?" and is used to allow you to specify
certain area codes and/or telephone exchanges that you want to
have TVD dial.
2) TVD looks for a Y or N in this field. This allows you to
configure the door so that it knows the format you want to use
for dialing a local number as opposed to a long distance number.
3) The third field is the letter associated with the time period to
allow TVD to dial. The letters and their associated time
periods are listed in the TCBVTIME file.
4) The dialing string format field tells TVD how to issue a dialing
string for a user phone number. If the letters DP or dp (for
pulse dialing) are detected in the dialing string, TVD will wait
10 seconds after issuing a dialing command to your modem before
beginning the scan for result codes.
The Verify Door compares the number that the user entered with
each entry in TCBVAL until it finds an entry that matches.
The more specific entries should be placed at or near the beginning
of the file (the ones with the fewest wildcards). The Verify Door
will compare the prefix, suffix, and area code and the answer to the
long distance question. If the number and answer to the long
distance question matches with an entry in TCBVAL, that line will be
used for dialing the users number. If not, The Verify Door will go
to the next line and keep going until it reaches a matching entry or
the end of the file. If no match is made, The Verify Door notifies
the user that the number is not available for callback.
A NOTE ABOUT LONG DISTANCE DIALING
If you have configured TVD to disable long distance dialing
and the user has answered Y to the long distance question, he/she
will see a message that long distance dialing has been disabled.
TVD will then return to PCBoard without dialing out. See the
explanation for line 3 of the config file for more information on
disabling long distance dialing.
9.6.1 Dialing string Format
─────────────────────
The dialing string format tells The Verify Door how to dial the
telephone number (e.g. ATDT%02%003 or ATDT1%01%02%003 etc.) The
table below shows each dialing string format and how it affects
dialing.
Key: [%01] = area code user entered
[%02] = prefix user entered
[%003] = suffix user entered
ATDT%02%003 ── Dials last 7 digits only using Tone dialing
ATDT1%02%003 ── Dials '1' and last 7 digits using Tone dialing
ATDT1%01%02%003 ── Dials '1' +area + 7 digits using Tone dialing
ATDP%02%003 ── Same as above using pulse/rotary dialing*
*Note: If you don't have touch tone service on your phone line(s) then
change the ATDT entries to ATDP to tell the modem to pulse dial
as shown in the example.
Sample TCBVAL file
──────────────────
407-???-????,N,A,"ATDT%02%003"
407-???-????,Y,B,"ATDT1%02%003"
???-???-????,Y,C,"ATDT1%01%02%003"
The first line in the sample file allows local calls (user answered
N to the long distance question) and the number was within the 407
area code) to be dialed. For example, if the user entered
407-555-1212 and N to each prompt in The Verify Door, The Verify
Door would send the following string to the modem: ATDT5551212 and
would allow the user to remain connected afterwards, returning the
user to the PCBoard. (You can configure TVD to ALWAYS hang up at
end of verify. See entry #18 of TCBV.CNF file)
The second line in the above file would allow Long distance calls
within the 407 area code (user answered Y to the long distance
question and entered 407 as his area code), the number would be
dialed as: ATDT15551212 and would be disconnected after the user
entered his/her password , provided the call was within the time
period specified by B in the TCBVTIME file. (Long distance calls are
ALWAYS disconnected)
The third entry in the above file allows Long distance calls outside
of the 407 area code (user answered Y to the long distance question
and put in an area code other than 407) provided the call was within
the time period specified by C in the TCBVTIME file. Say the user
put in 201, 555, 1212, N , for the area code, prefix, suffix and
long distance questions respectively. The Verify Door would send
ATDT12015551212 to your modem and would disconnect after the user
entered his/her password.
If you intend send setup commands to your modem within the TVD
dialing string you might first verify that the dialing string you
intend to use works in your favorite communications program before
putting it into a TVD dialing string.
9.7 TCBVAREA
────────
The TCBVAREA file is used to tell The Verify Door what area code
or area codes are in the local calling area for your BBS. This file
is used to prevent callers who have previously been verified and are
calling local from entering a false area code and their real prefix
and suffix and then getting verified.
Here's how it works: (Registered version only) If a caller calls
from within your local area code(s) listed in TCBVAREA and tells TVD
it is a local call, TVD will temporarily replace the area code that
the user entered with the area code(s) of your local dialing area
and THEN will check the TCBVVER file for a duplicate number.
Although this file must be in place on your system, TVD will check
the TCBVAREA and TCBVVER files for false area codes and already
verified numbers only when registered.
9.8 LOG FILE
────────
The log file used by The Verify Door can be configured to either
append entries to your PCBoard caller log or to a log text file of
your choice. The path and filename for the log file is configured in
the config file for The Verify Door, TCBV.CNF is the default config
file name.
Log file entries include the following types of entries:
BUSY
NO CARRIER
VOICE
RING DETECTED
NO DIAL TONE
NO DIALTONE
NO ANSWER
CONNECT
No response from modem
Wrong Password: [password entered]
Bad Number not dialed
User name [date time]
Carrier Lost ...
Not at new user level
Bad number not dialed
Aborted
Illegal dial time for [phone number]
Maximum redials reached
[phone number] already verified to [user name]
Number dialed: [phone number] [(Long Distance)] [(Local)]
User pressed only ENTER when prompted for password
Improper or no user response to prompt
Successful Verify
Caller logged of by TVD
Local call returned to PCBoard
10.0 The Verify Door OPERATION
─────────────────────────
Invocation of The Verify Door (usually done by the PCBoard
running a batch file) is pretty straightforward. Below are sample
batch files for invoking The Verify Door. A sample batch has been
included in the archive for your convenience. No other auxiliary
programs, or drivers are required as TCBVDxxx.EXE is actually a
stand-alone communications program specifically written to interface
with PCBoard.
Note: TVD probably will not work with fossil drivers. Since
PCBoard does not require the use of a fossil driver, it is assumed
that none are in use.
********************************************************************
10.1 Status bar description
──────────────────────
If you have it enabled, a two line status bar will be displayed
at the bottom of your screen when TVD is running. It wil display the
users name, time, date, security level, modem activity/results, and
several countdown/delay timers.
Here's what the status bar display means:
User Dial
Baud MNP User Name Future Use Attempt #
┌────┐┌┐ ┌───────────┐ ┌───────────────────┐ ┌───────────┐
┌─────────────────────────────────────────────────────────────────────────────┐
│The Verify Door (2400E) JANE LOCKHART Attempt # 1 │
│02-02-1992 12:54:57 T/O= 1 Sec= 1 Status: Polling modem Wait: 59│
└─────────────────────────────────────────────────────────────────────────────┘
└────────┘ └──────┘ └─────┘ └─────┘ └────────────────────┘ └──────┘
Date Time # Times Security Modem result codes and Timers
On Level program activity (seconds)
********************************************************************
10.2 SINGLE NODE OPERATION:
cd d:\door } You should put all TVD
associated files in a separate
directory
tcbvd121 d:\door\tcbv.cnf } Command line to invoke the door
using TCBV.CNF as the configuration
file and runs The Verify Door.
cd d:\pcb }
board } Returns to PcBoard
PCBSetup Door Security File Example:
Filename Password Sec Login SYS SYS Shell
══════════ ════════════ ═══ ═════ ════ ════ ═════
1) VERIFY 1 Y N N N
********************************************************************
10.3 MULTI-NODE OPERATION
────────────────────
The Verify Door performs share-compatible reads/writes with all
files. In the event that the files are not network compatible, your
configuration for each node must specify a different filename.
Usually the best method of doing so is to append a '1', '2' (etc.)
to the end of the filename. The files NOT compatible between nodes
are listed below.
You should make a different config file for each node, such as
TCBV1.CNF for node 1, TCBV2.CNF for node 2, and make the appropriate
changes in the batch file that loads the door from each node.
(See above examples)
FILES NOT COMPATIBLE BETWEEN NODES:
SYS file (PCBoard.Sys)
LOG file (Callers log or text file for The Verify Door log)
FOR MULTI-NODE OPERATION:
NODE1 batch:
cd d:\door } You should put all TVD
associated files in a separate
directory
tcbvd121 d:\door\tcbv1.cnf } Command line to invoke the door
using TCBV1.CNF as the configuration
file and runs The Verify Door.
cd d:\pcb }
board } Returns to PcBoard node 1
NODE2 batch:
cd d:\door } You should put all TVD
associated files in a separate
directory
tcbvd121 d:\door\tcbv2.cnf } Command line to invoke the door
using TCBV2.CNF as the configuration
file and runs The Verify Door.
cd d:\pcb2 }
board2 } Returns to PcBoard node 2
*******************************************************************
10.4 Exit Codes
──────────
Starting with v1.21, when a REGISTERED version of TVD completes
execution, it will return one of several different DOS Errorlevel
codes (exit codes) for those sysops who wish to do additional
processing depending on what the user does while in TVD.
The following is a list of the exit codes returned and the
meaning of each:
DOS Errorlevel What it means
────────────── ─────────────
0 Successful verify
1 Carrier lost
2 Aborted
3 User pressed only ENTER at password prompt
4 No response from user to prompt
5 Not at new user level
6 Long distance # not dialed
7 Bad # not dialed
8 Illegal dial time
9 Incorrect password
10 Already verified
11 Maximum redials reached
99 TVD system error. Check ERROR.LOG
11.0 REGISTERING The Verify Door
──────────────────────────-
Do NOT register this software unless you are satisfied that it
will fulfill your verify-by-callback requirements!
Do NOT register this software if you have not verified that it
runs successfully on the system on which you intend to run it!
In order to register The Verify Door, fill out the last page of
this document and send it to the address shown along with a check
or money order for $20.00 US. You will then be mailed a registration
number. After placing this number in your configuration file you
will have a full registered version of The Verify Door for this
and all future releases as stated above, including any updates
compatible with PCBoard v15.0.
Why register? You are requested to register The Verify Door
after running it for a period of no longer than 30 days. However, I
am aware that many sysops will not adhere to this policy, and have
therefore included advanced features that only registered systems
receive, as an incentive.
One of these features is the capability to read numbers from the
TCBVVER file before they are dialed / verified and to check
for previously verified numbers. Another feature that will not work
unless the door is registered is the configurable upload/download
statistics listed in lines 21-24 of the config file. Also, only
the first three lines of the TCBVNAL (trashcan) file will be
checked in the demo version.
12.0 TECHNICAL SUPPORT
─────────────────
Page Three BBS
Node 1: (407) 327-8421
Node 2: (407) 327-4524
PC-Pursuit: FLORL
24 hours / 7 days
Node 1: 12/24/96/38.4k baud HST
Node 2: 1200/2400 baud mnp
Jim Lockhart, Sysop and Author
Sysops that request access to Page Three will be granted
extended privileges only upon mail registration or by request when
TVD registration is received. Since there are many people that call
Page Three BBS only once or twice to download The Verify Door it is
difficult and often useless to try to keep track.
If you are having a problem getting The Verify Door set up for
use on your system, feel free to call Page Three and leave comment
to the sysop describing in as much detail as possible the problem
you are having. Be sure and include the ERROR CODE(S) of the
error(s) in question. (You may find that a file called ERROR.LOG
is in the directory in which TCBVDxxx.EXE resides)
Special thanks to all the many boards and Sysops that gave
recommendations to me for future versions of The Verify Door. I
hope that I've done a good job and that all of you enjoy it!
13.0
The Verify Door REGISTRATION FORM
_________________________________
Sysop name: _________________________________________
Address: _________________________________________
City, State, Zip: _________________________________________
Home phone #: _________________
TVD Version : ______v1.21______
Please type (or print carefully) below the name of the bbs to
register exactly as you want it to appear on screen. Mixture of
capital and small letters is OK. Your registration number is
determined using your bbs name and is CASE SENSITIVE.
Board to register: (EXACTLY as you want it to appear on screen,
case sensitive.)
___________________________________ Phone: ____________
Make your check or M.O. for $20.00 US payable to Jim Lockhart
and mail to:
Jim Lockhart
The Verify Door Registration
317 San Miguel St.
Winter Springs, FL 32708
You will receive your registration number a few days after I receive
your form. If you do not receive a registration number after
approximately 3 weeks, please contact Page Three BBS. If you wish, I
will call your system after your payment is received and leave you a
comment with your registration number.
If you would like to have me call your system with your registration
number, please open a user account for for me per the following:
User Name: Jim Lockhart
Password : ____________ (pick one for me, I'm not choosy!)
----------- Do not write below this line - 'for office use only' -------------
Encrypted BBS name :
Registration number:
Date notified :
------------------------------------------------------------------------------